home *** CD-ROM | disk | FTP | other *** search
/ Suzy B Software 2 / Suzy B Software CD-ROM 2 (1994).iso / bootup / boot_a2m / cache277 / cache.doc next >
Text File  |  1995-05-02  |  20KB  |  371 lines
  1.  
  2.                         *** Master Cache V2.77 ***
  3.  
  4.                           Copyright (c) 1992,1993
  5.                        Made by: Daniel Carl Gouthro
  6.                         Created at October 12,1992
  7.                         Updated at October 28,1993
  8.  
  9.     It is best disk caching system for ATARI ST,Mega ST,STe,Mega STe and
  10. TT and Falcon! It support any logical size up to 8192 bytes per sector,
  11. write delay caching,TOS buffers configuration for TOS V1.4 or higher,
  12. FAT/DIR priority option,many other features you can't refuse to accept
  13. this program!!! It is DEMO version of Master Cache V2.77 that can be
  14. upgraded to full registered version by enter the password. See end
  15. of text about how to register this copy. BONUS: Master Cache V2.77
  16. just like ICD will WORK on TT and Falcon,too!
  17.  
  18.     NOTE: Write delay cache will NOT report any errors most of the time.
  19. Because of it,you should not cache these floppy disks if they are write
  20. protected. These disks allow you to update files or directory but will
  21. not be written to the disk. If you like to cache the disks,you must
  22. not write protect the disks!!! But however it will report any errors if
  23. you disable write delay cache flag.
  24.  
  25.                     Installing your Master cache program
  26.  
  27.     You can install Master cache program on boot floppy disk or hard
  28. disk where you like to install. You must place the program CACHE.PRG
  29. into AUTO folder then re-boot the computer. It will install by itself
  30. and start to cache the disk(s) which is being cached. You can see
  31. the information during booting the computer.
  32.  
  33.                     Configurating your Master cache program
  34.  
  35.     It is MOST advanced features you will take advangtes is configuring
  36. your Master cache program. It is called CACHECFG.TOS. It also include
  37. password upgrade module in it.
  38.  
  39.     You can put CACHECFG.TOS into any folder but must be reside on same
  40. disk as CACHE.PRG is. However,if you have hard disk,you can put CACHECFG.PRG
  41. on any partitions,even not in C: at all.
  42.  
  43.     When you run this program,it will ask you to choose floppy disk or
  44. hard disk to configure for. Press A or C to continue. If you receive
  45. opening the file error,don't despair! It mean you do not have configuration
  46. file called DANCACHE.DAT file. It will automatically select default
  47. configuration and make new serial number by itself. It will put you
  48. into DEMO version. Remember to save configuration file immediately if
  49. you get new serial number.
  50.  
  51.     Main menu has many commands you will LOVE to! Choose any letters
  52. you like.
  53.  
  54.     Change drives to be cached - This will configure which drives to be
  55. cached. If you press A,it will toggle drive A: cache flag. If you re-boot
  56. and these drive which is not flagged will be bypassed and goes normally
  57. to the disk without cached. If these drives is flagged,it will be cached.
  58.  
  59.     Password - This will let you enter the password to upgrade to full
  60. version. See end of text for more detail(s).
  61.  
  62.     Save configuration - This will save configuration file to selected
  63. drive you chosen at beginning of the program. It will also save validated
  64. full version module to same drive.
  65.  
  66.     Quit - This will quit the program. It will ask you if you like to
  67. save configuration file before quitting.
  68.  
  69.     Change cache block and sector size - This will allow you to configure
  70. cache size.
  71.  
  72.         Cache block is number of cache blocks, each block hold number of
  73.     sectors which is cached. You can enter number of cache block from
  74.     1 to 1024. Sector blocks is sector size per cache block. You can
  75.     enter number of sectors per cache block from 1 to 128. If you
  76.     select 1 on sectors,each sector the disk read will be cached if
  77.     possible. Performance will be affected by this option. You can
  78.     experiment with these to find best performance.
  79.  
  80.     Change maximum number of sectors to be cached - This will allow you to
  81. change maximum sectors to be cached. If disk read or write exceed this
  82. maximum sectors length then the cache system will be bypassed for this
  83. operation. Most time,you should enter 150% of sector block into this
  84. number to give best performance. If you have 8 sectors per cache block
  85. then you enter 12 on this number. If you have floppy disk,you can enter
  86. 4 times of sector block on this number to speed up disk operation.
  87. There is no obligation to enter any number other than recommanded,you
  88. can reduce the performance if you set too small or too much.
  89.  
  90.     Change TOS buffers - This will allow you to change TOS buffers upon
  91. booting the computer. It is only useful for TOS V1.4 or higher owners!
  92. TOS V1.0 and V1.2 users can change any number higher than 0 but it simply
  93. allocate the memory and allocated memory is lost (wasted!). TOS V1.4 or
  94. higher owners can set data buffers or FAT/DIR buffers any number from
  95. 0 to 255. 0 will disable each buffers. TOS V1.0 and V1.2 users should
  96. always set both buffers to 0. This feature allow TOS V1.4 or higher
  97. users can remove CACHEXXX.PRG provided by ATARI Corp.
  98.  
  99.     Change write delay time - This will allow you to adjust time it
  100. will take before write to the disk will occur. It is useful only if
  101. write caching is enabled. You can set from 0.5 to 99.9 seconds.
  102. You should wait after last operation for seconds depend you configured
  103. before it will be written into the disk before you remove the disk from
  104. the drive. Removing the disk before it is written could damage the disk!
  105.  
  106.     Change maximum logical size - This will let you change maximum
  107. logical size. The sub-menu appear and you will select number that
  108. match bytes per sector you want. If you have 512 bytes per sector,you
  109. select 9. Any partition that exceed maximum logical size will not be
  110. cached. NOTE: If you have set up TOS buffers,you must select maximum
  111. logical sector to match largest logical size on any partition you have.
  112. On Master Cache V2.76 or later,you can set logical sector size for EACH
  113. cache AND TOS buffers. You can set cache size to smaller and set TOS
  114. buffer larger. NOTE: The cache will automatically be bypassed if hard
  115. disk partition has larger sector size than cache sector size but TOS
  116. buffers is NOT bypassed so you must set TOS buffer to be largest logical
  117. size possible as any LARGEST partition on your hard disk. Example if C:
  118. has 512 bytes and D: has 1024 bytes,you must set TOS buffer to 1024
  119. bytes per sector or the system will crash when you try to access D:.
  120.  
  121.     Change cache flags - This is most important you will use.
  122.  
  123.         Write delay cache flag is the switch that you will "cache"
  124.     write operations. If you enable this,all write operation will be
  125.     cached and the timer will automatically be activated when you
  126.     re-boot the computer. If there is write pending flagged on cache
  127.     block then it will be written on the disk after the time expire.
  128.     NOTE: Write delay cache will not report any errors from any disk!
  129.  
  130.         FAT/DIR priority flag is the switch that FAT/DIR will more
  131.     likely to be cached more than the data. If you disable this,FAT/DIR
  132.     will be treated as the data. If you enable this,FAT/DIR will be
  133.     cached as maximum priority. If you enable this as "SUPER",FAT/DIR
  134.     will be cached as one level higher than maximum priority and will
  135.     less likely to be flushed when all data is at maximum priority and
  136.     no more cache block left for new sector to be read. If you enable
  137.     this as "LOCKED",FAT/DIR will be cached and can't be flushed unless
  138.     all cache blocks have FAT/DIR. You must set FAT/DIR priority flag
  139.     to be NORMAL ENABLED if you want best performance on TOS V1.0 and V1.2.
  140.     You do not need this if you have TOS V1.4 or higher but you can
  141.     enable this if you like higher performance.
  142.  
  143.         Change maximum priority list - This will let you change maximum
  144.     number of priority list. If you set to 4 then there will be 4
  145.     priority lists each cache block. If you set to 8 then there will
  146.     be 8 priority lists each cache block. More priority list will give
  147.     any sector which bearing highest priority will stay in the cache
  148.     for much longer time. Best performance is about 4 to 8.
  149.  
  150.         Change cache age delay time length - This will let you adjust
  151.     cache age delay time length. This is most important for the people
  152.     who switch from big application to another application which involve
  153.     big disk activity such Lattice C V5.5,Style V1.1 load/save many
  154.     pictures,many other program(s). When the time expire on age delay
  155.     time you specified,it will cause lower all older cache block's priority
  156.     so allow new recent data will be loaded into older cache block and
  157.     flush older data. Next time,you access recent data,it will be read
  158.     from the cache likely. It is most useful when all cache blocks are
  159.     filled up with old high priority data from same disk. It will allow
  160.     you to set from 3.0 to 499.9 seconds. You can enter 0 to disable this
  161.     feature. NOTE: This feature will NOT lower FAT/DIR priority if you
  162.     set FAT/DIR priority to SUPER or LOCKED.
  163.  
  164.         NEW! Version 2.76 feature - media change check - This will let you
  165.     enable or disable media change. Default is ENABLED. If it is enabled,
  166.     when media change occur (disk is changed or disk tool forced media
  167.     change) then all cache blocks are flushed and invalidated except
  168.     any block that are still write pending. Write pending block will
  169.     still be written only if media change occur and you do not change
  170.     the disk. You must ENABLE media change check if you cache floppy
  171.     disk or removeable hard disk. This will prevent damages to the disk
  172.     that are changed. You can disable this only if you cache fixed hard
  173.     disk. It will cache more sectors but will not check if the disk is
  174.     changed. Use with extreme caution if you disable media change check.
  175.     I am strongly recommand you to wait for seconds you specified for
  176.     all write pending operation will be written to the disk before you
  177.     change the disk or use disk tool such disk editor or disk optimizer.
  178.  
  179.         NEW! Version 2.76 feature - precaching - This will let you to
  180.     configurate pre-cache features. There are two settings you can edit.
  181.     Pre-caching blocks is number of blocks the cache will pre-cache from
  182.     selected drives when cache program (AUTO folder) is run. Setting this
  183.     blocks to 0 to disable pre-caching. Pre-caching drive is the drive
  184.     you want to pre-cache. You can pre-cache only ONE drive at a time.
  185.     You can choose A to P for this. If you select C: as pre-caching,it
  186.     will speed up AUTO programs AFTER cache program is run. It is useful
  187.     for older TOS users (pre-TOS V1.4). You should not set pre-caching
  188.     blocks exceeding number of cache blocks you defined or it will
  189.     simply slow down processing and flush older data from the cache.
  190.  
  191.                       Change the switch during the session
  192.  
  193.     This option in configuration program let you change your cache switches
  194. during cache is in progess. If you try to access it by press 'O' and
  195. the cache is not installed,the error message will appear. You must have
  196. the cache installed before you can use this option. The cookie is used
  197. by Master Cache V2.77. It is called 'CACH' cookie name. It bears base
  198. address that configuration program can modify internally in the memory.
  199. This option also give you brief information about cache statastic(s).
  200.  
  201.     Change write cache flag and FAT/DIR priority flags are same effect
  202. as above except it will take effect immediately. NEW! Media change
  203. check flag are same effect as above except toggle media check immediately.
  204.  
  205.     Change drives to be cached does same thing as above except this
  206. will toggle drive to be cached immediately instead of re-booting. It
  207. also flush any cached blocks that match drive letter you toggled.
  208.  
  209.     Change age delay time length does same thing as above except this
  210. feeling will take effect immediately.
  211.  
  212.     The statistic will give you useful information about the cache
  213. performance. These statistic will be displayed right when you access
  214. this area.
  215.  
  216.     Read Block is number of read blocks TOS access to the disk.
  217.     Read Cached is number of read blocks which already in the cache.
  218.     % Performance is how the cache performance "feeling".
  219.  
  220.     Write Cache is same statistic as above. Write Cached is writing
  221.     the block is already in the cached and will be written as soon as
  222.     the timer expired (the time taken after last operation of accessing
  223.     the disks). NOTE: It is also counted even if write delay cache is
  224.     DISABLED,it mean it will cache these blocks at next read access.
  225.     It is called write through cache unless write delay cache is enabled.
  226.  
  227.     NOTE: Read block and Write block will not be counted if the disk access
  228.     exceed maximum sectors length to be cached.
  229.  
  230.     There is an option to view more detailed information about the cache.
  231. Press X to get detailed information on EACH cache block! It will give you
  232. each cache block about drive number,starting sector number,priority
  233. and write pending. If there are more than 16 cache blocks,you can press
  234. any key to continue to next page of detailed cache information.
  235. NOTE: If cache block is empty or not valid,DIRTY/INVALIDATED/UNUSED
  236. message will appear beside cache block number.
  237.  
  238.                       Registering Master Cache program
  239.  
  240.     DEMO version of Master Cache will allow you to cache the disk at very
  241. limited performance. You are limited to 16K cache block(s) or so. You are
  242. not allowed to use any other features such TOS buffers,write caching,
  243. FAT/DIR priority,etc... However,you are allowed to use drives to be
  244. cached can be configured (Toggle the drives to be cached).
  245.  
  246.     If you like to register this copy,send me $15 registration fee and
  247. wait for the password to arrive. You can send the cheque or money order.
  248. Do NOT send the cash! The cash is easily be stolen in the mail.
  249.  
  250.     Sending the cheques or money order ($15) to me along with your
  251. serial number to:
  252.  
  253.         Mr. Daniel Carl Gouthro
  254.         42 Pinson Private
  255.         Ottawa,Ontario (CANADA)
  256.         K1V 0E6
  257.  
  258. Be sure,you must give me your name and your address or I can't able
  259. to give your password! You must also send me your serial number,too!
  260.  
  261. After you sent your cheque or money order for the password,DO NOT
  262. DELETE DANCACHE.DAT file!!! It contain valuable serial number in it
  263. and it is valid only for the password you get. The password will WORK
  264. only with the serial number in DANCACHE.DAT which you sent me serial
  265. number.
  266.  
  267. After you got the password and registered it,you will enjoy FULL
  268. benefits of Master Cache program - BEST disk caching system for ATARI
  269. ST computer!!!
  270.  
  271. Last minute update to this document:
  272.  
  273.     Master Cache V2.77 are fully support media change recgonize and
  274. will automatically re-read from the disk after the disk is changed.
  275.  
  276.     NOTE: You MUST not cache floppy disks if you are backing up
  277. with diamond program,toolkit program or disk editing such DLII or
  278. other disk editor. These programs bypass operating system and directly to
  279. the disks. But you can cache hard disk since they must use operating
  280. system to order to access hard disk. It will force your master cache
  281. to flush the cache.
  282.  
  283.     You can cache ICD hard disk with Master Cache V2.77,even if ICD
  284. caching is enabled. However,I am strongly recommand you disable both
  285. ICD read cache and write cache. However,you can keep write verify
  286. enabled since Master Cache V2.77 do not have write verify feature.
  287. Enabling cache on BOTH ICD and Master Cache V2.77 will take much
  288. more memory than needed! You can choose ICD or Master Cache if
  289. you wish to. You need Master Cache program if you have any hard disk
  290. other than ICD (SCSI) and you do not have ICD host adapter.
  291.  
  292.     You can still use FOLDRXXX.PRG to expand the folder since Master
  293. Cache V2.77 do not have folder expander because there is no documented
  294. system variable for the folder. There are documented system variable
  295. for cache and TOS buffers only. I will try to collect undocumented
  296. system variable for expanding folder and I hope I will include it in
  297. future versions.
  298.  
  299.                     *** Master Cache V2.76 Upgrade ***
  300.  
  301.     This is minor bug fix on processor's stack. Earlier version
  302. did corrupt main code during hard disk driver is called but will
  303. not disrupt hard disk operation unless hard disk driver filled up
  304. more than 256 bytes on stack then terrible things will occur and
  305. damage your files on hard disk. Only few programs are victim of this
  306. condition. This bug has been fixed and now handle stack frame correctly.
  307. It has allocated 1024 bytes for stack use but earlier version did not
  308. use it that it should be used.
  309.  
  310.                     *** Master Cache V2.77 Upgrade ***
  311.  
  312.     There is two bugs in Master Cache V2.76. One bug allowed you to get
  313. more cache when you are in DEMO version. It has been fixed. One another bug
  314. is media change check which caused formatting to fail at end of cycle (on
  315. floppy disk). It has been fixed. Also media change check had been tighted.
  316. Now media change check is ALWAYS work with every disk inserted.
  317. One changes made into Master Cache V2.77 is write delay cache will not
  318. WRITE to floppy disk or any disk that are changed to prevent corruption
  319. to new floppy disk inserted into the drive. Though,your previous disk
  320. which is removed before being written are corrupted.
  321.  
  322.     * BONUS * This demo version cache memory limit has been increased from
  323. 8K to 16K!
  324.  
  325.                       *** NOTICE! NOTICE! NOTICE! ***
  326.  
  327.     I am not responsible for any damages done to any floppy disks or
  328. hard disks or other drives as result of use,misuse or abuse of this
  329. program. I will not be liable for any damages you caused with this
  330. program. This program is a copyrighted and you can give away to any
  331. people or upload to BBS if you like but you MUST not sell this program.
  332. You are *NOT* allowed to give away or upload your program if your
  333. program is a registered version. If you plan to give away,you can do by
  334. give everything away except DANCACHE.DAT file. You must keep DANCACHE.DAT
  335. file strictly personal. Your password is also strictly confidential!
  336.  
  337.     I have extensive tested my Master Cache V2.77 and found it worked
  338. perfectly on all hard disks without any one gitches! You can try Master
  339. Cache and you will find no gitches at all. However it is ABSOLUTELY
  340. no warranty of this Master Cache program.
  341.  
  342.  
  343.     I am working on COMMERCIAL version of Master Cache and will release
  344. soon. I did not get an application from New Deminision company yet.
  345.  
  346.     There is lists of features for COMMERCIAL version not in shareware
  347. version.
  348.  
  349.         o Write verify operation with adjustable verify buffer
  350.  
  351.         o Write protect on any drives you define
  352.  
  353.         o Each drive own write delay switch instead of global switch.
  354.  
  355.         o Printed manual with reference
  356.  
  357.         o MUCH more!!!
  358.  
  359.                                                 Made by:
  360.                                                     Daniel Carl Gouthro
  361.  
  362. I am Master programming in C (Natural Master Level 46). I am near
  363. Doctor programming in C and assembly language. I am currently wearing
  364. big blue-black-blue hood and it are getting bigger and bigger....
  365. and change color toward the purple slowly!
  366.  
  367. Natural Master levels is far more than mountain master but
  368. less than doctor level. Doctor level's hood is Biggest pink-purple-pink
  369. hood with the silk. (D.C.S.!)
  370.  
  371.